home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 014 / pattr.arc / PATTR.DOC next >
Text File  |  1986-10-15  |  13KB  |  409 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.                               P A T T R I B U T E
  20.  
  21.                                        by
  22.  
  23.                                  Norm Patriquin
  24.  
  25.  
  26.  
  27.                                    Version 1.0
  28.                                    October 1986
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.                        Copyright 1986 by Norm Patriquin
  37.  
  38.  
  39.  
  40.                         Table of Contents
  41.  
  42.  
  43.       What is PATTRIBUTE. . . . . . . . . . . . . . . . . . . .   1
  44.  
  45.       Features  . . . . . . . . . . . . . . . . . . . . . . . .   2
  46.  
  47.       Command Mode Parameters . . . . . . . . . . . . . . . . .   3
  48.  
  49.       Examples  . . . . . . . . . . . . . . . . . . . . . . . .   7
  50.  
  51.       Registration. . . . . . . . . . . . . . . . . . . . . . .   8
  52.  
  53.       Problems and Maintenance. . . . . . . . . . . . . . . . .  10
  54.  
  55.       Version History . . . . . . . . . . . . . . . . . . . . .  11
  56.  
  57.                                                                 Page  1
  58.  
  59.  
  60.       What is PATTR
  61.       ---------------
  62.  
  63.       PATTR sets DOS attributes for the files or filename wildcards
  64.       you specify.  Use it to set or reset archive status on files or
  65.       to protect/unprotect files with the readonly attribute.
  66.  
  67.       PATTR's file selection parameters provide you with numerous
  68.       options for specifying the files to be deleted.  You may select by
  69.       directory, file, date, attribute, size, and even starting and
  70.       ending filename.
  71.  
  72.  
  73.                                                                 Page  3
  74.  
  75.  
  76.       Command Parameters
  77.       ------------------
  78.  
  79.       PATTR allows several command parameter switches to be specified
  80.       to customize the process.  All these parameters are optional.
  81.       The command format and switch parameters are described below.  A
  82.       quick review of command parameters is always available by
  83.       entering the PDEL command with no parameters.
  84.  
  85.       COMMAND FORMAT:
  86.  
  87.       PATTR   filespec  [ (/ switches) ]
  88.  
  89.  
  90.       filespec  Enter a DOS file specification.  Pathnames and
  91.                 standard DOS wildcard characters are allowed.
  92.  
  93.  
  94.       /SA       Select files having the ARCHIVE attribute set.
  95.  
  96.  
  97.       /SS       Select files having the SYSTEM  attribute set.
  98.  
  99.  
  100.       /SH       Select files having the HIDDEN  attribute set.
  101.  
  102.  
  103.       /SR       Select files having the READONLY  attribute set.
  104.  
  105.  
  106.       /SO       Only useful when /SA /SS /SH /SR is also used.
  107.                 Indicates that files without HIDDEN, SYSTEM,
  108.                 READONLY attributes are also to be selected.
  109.  
  110.  
  111.                                                                 Page  4
  112.  
  113.  
  114.       /D:[(]xxx Date.  Select files based on the relationship between
  115.          [)]    their last update date and the date specified.  This
  116.          [=]    parameter includes a date or number of days value.
  117.                 It may also contain a modifier that reverses or
  118.                 modifies the use of the date specified.
  119.  
  120.                 When xxx contains a date the date is compared to the
  121.                 last update date of the file.  The last update date
  122.                 of the file is the date contained in its directory
  123.                 entry.  The file is selected if the condition specified
  124.                 by the condition modifier is met.  The condition
  125.                 modifier meanings are:
  126.  
  127.                   '(' =  Select files whose date is older than the
  128.                          date specified.
  129.  
  130.                   ')' =  Select files whose date is newer than the
  131.                          date specified.
  132.  
  133.                   '=' =  Select files whose date is equal to the date
  134.                          specified.
  135.  
  136.                 If the condition modifier is not specified, ')' is
  137.                 assumed.
  138.  
  139.                 Date values may be specified in any of the following
  140.                 formats:
  141.  
  142.                     MM/DD/YY   MM-DD-YY   DDMMMYY
  143.                     12/31/80   12-31-80   31DEC80
  144.  
  145.                 If xxx contains a numeric value, that positive number
  146.                 is used to calculate a date value a number of days
  147.                 prior to the current date.  Then that date is used
  148.                 as in the calculation above.
  149.  
  150.                 Example:
  151.  
  152.                 /D:(1JAN86  - Process files updated before 1JAN86
  153.                 /D:)1JAN86  - Process files updated after 1JAN86
  154.                 /D:=1JAN86  - Process files updated 1JAN86
  155.                 /D:(5  - Process files modified prior to 5 days ago
  156.                 /D:)5  - Process files modified within the last 5 days
  157.                 /D:=5  - Process files modified 5 days ago
  158.                                                                 Page  5
  159.  
  160.  
  161.       /F:file   First.  Indicates that processing is not to start until
  162.                 the specified full filename is encountered in the
  163.                 scan of the directory.
  164.  
  165.  
  166.  
  167.       /L:file   Last.  Indicates that processing is to stop after
  168.                 the specified full filename is encountered in the
  169.                 scan of the directory. The file specified will be
  170.                 processed if it matches selection criteria.
  171.  
  172.  
  173.  
  174.       /M        Stop screen from scrolling from scrolling past the end
  175.                 without user intervention (MORE).
  176.  
  177.  
  178.       /O        Indicates that all filenames except those matching
  179.                 the filename specified on the input command are to
  180.                 be selected for processing.
  181.  
  182.  
  183.  
  184.       /P        Pause before each file is updated to allow user
  185.                 to approve or reject the action for each file.
  186.  
  187.  
  188.                                                                 Page  6
  189.  
  190.  
  191.       /SZ: [(] [)]  nnn    Select a file based on its size.  The
  192.                 left paren indicates that files less than the
  193.                 indicated size are to be selected.  The right
  194.                 paren indicates to select files greater than the
  195.                 size.  If right or left paren are not specified,
  196.                 a left paren is assumed.  Following are examples.
  197.  
  198.                 /SZ:100    --  Select files less than 100 characters
  199.                 /SZ:(100   --  Select files less than 100 characters
  200.                 /SZ:)100   --  Select files greater than 100 characters
  201.  
  202.  
  203.       /T        Test the command.  Use this switch when you
  204.                 would like to test the command entered without
  205.                 actually updating any files.
  206.  
  207.                 Messages will indicate what will happen if the command
  208.                 is executed without the /T switch.
  209.  
  210.  
  211.       /AY       Set the ARCHIVE attribute for the file on.
  212.  
  213.  
  214.       /AN       Set the ARCHIVE attribute for the file off.
  215.  
  216.  
  217.       /HY       Set the HIDDEN  attribute for the file on.
  218.  
  219.  
  220.       /HN       Set the HIDDEN  attribute for the file off.
  221.  
  222.  
  223.       /SY       Set the SYSTEM  attribute for the file on.
  224.  
  225.  
  226.       /SN       Set the SYSTEM  attribute for the file off.
  227.  
  228.  
  229.       /RY       Set the READONLY  attribute for the file on.
  230.  
  231.  
  232.       /RN       Set the READONLY attribute for the file off.
  233.  
  234.  
  235.                                                                 Page  7
  236.  
  237.  
  238.       Examples:
  239.  
  240.          Show all attributes for files in current directory
  241.  
  242.              PATTR *.*
  243.  
  244.  
  245.          Set ARCHIVE attribute off for all *.BAK files on disk
  246.          in drive A:
  247.  
  248.              PATTR *.BAK /S/AN
  249.  
  250.  
  251.          Set READONLY attribute on for all *.SPC files in \SAVE
  252.          directory.
  253.  
  254.              PATTR \SAVE\*.SPC /RY
  255.  
  256.  
  257.          Set HIDDEN attribute on for all files in \SECRET directory
  258.  
  259.              PATTR \SECRET\*.* /HY
  260.  
  261.  
  262.          Reset all attributes for all files in current directory
  263.  
  264.              PATTR *.* /AN/SN/HN/RN
  265.  
  266.  
  267.                                                                 Page  8
  268.  
  269.  
  270.       Registering PATTR
  271.       -------------------
  272.  
  273.       PATTR is distributed under the Shareware concept.  This makes it
  274.       available for anyone to try without obligation.  If you decide it
  275.       is useful and want to keep it, I ask that you register your use
  276.       of it.  This will allow for continued support and maintenance of
  277.       the program and will help to encourage that more quality software
  278.       be made available through this channel.   We require all
  279.       corporate and government users of this utility register their
  280.       copies.
  281.  
  282.       To simply register the program, $15 is requested.  If you would
  283.       like the newest program disk and a copy of the manual send
  284.       $30.  If you would like to register all the Patriquin utilities,
  285.       and receive programs on disk and manuals, send $45.
  286.  
  287.  
  288.       Send registration requests to:
  289.  
  290.                       Norm Patriquin
  291.                       P.O. Box 8308
  292.                       San Bernardino, CA   92412
  293.  
  294.  
  295.       The registration charge is a one time fee that entitles you to
  296.       all future versions of the product.  These may either be obtained
  297.       from normal Shareware sources or directly from me.  Any
  298.       organization ordering more than 100 copies is also entitled to
  299.       telephone support and will be given the technical support number.
  300.  
  301.       Following is a form that may be used to register PATTR.
  302.  
  303.                                                                 Page  9
  304.  
  305.                              PATTR Registration
  306.                                  Version 1.0
  307.  
  308.  
  309.       Please Register PATTR to the following person.  We will use ____
  310.       copies  of  the program and have enclosed $____ for each copy to
  311.       be used.
  312.  
  313.       **************************************************************
  314.  
  315.       _____ Registration only..............................   $15.00
  316.  
  317.       _____ Registration, program disk and manual..........   $30.00
  318.  
  319.       _____ Registration of all Patriquin Utilities with
  320.                program disks and manuals...................   $45.00
  321.  
  322.       _____ Update of newest Patriquin Utility disk with
  323.                manual.  ...................................   $15.00
  324.  
  325.       **************************************************************
  326.  
  327.  
  328.       Name: __________________________________________________
  329.  
  330.       Company: _______________________________________________
  331.  
  332.       Address: _______________________________________________
  333.  
  334.                _______________________________________________
  335.  
  336.       City: ______________________________  State: ___________
  337.  
  338.       Zip:  ______________________
  339.  
  340.       I obtained my copy of PATTR from: ____________________________
  341.  
  342.       If BBS indicate name and number please._________________________
  343.  
  344.       ________________________________________________________________
  345.  
  346.       Please register the software under the following name:
  347.  
  348.       ____________________________________________________
  349.  
  350.               Send to:
  351.                       Norm Patriquin
  352.                       P.O. Box 8308
  353.                       San Bernardino, CA  92412
  354.                                                                 Page 10
  355.                                P A T T R
  356.  
  357.       Problems and Maintenance
  358.       ------------------------
  359.  
  360.       I welcome all comments or enhancement suggestions. Please
  361.       document each item clearly and provide printed examples if
  362.       possible.  Please be sure to include this form with all requests,
  363.       it will help to make sure we can provide you with the best
  364.       possible service.
  365.  
  366.  
  367.       Name: __________________________________________________________
  368.  
  369.       Company: _______________________________________________________
  370.  
  371.       Address: _______________________________________________________
  372.  
  373.                _______________________________________________________
  374.  
  375.       City: __________________________________  State: _______________
  376.  
  377.       Zip: ______________________________
  378.  
  379.       Telephone: _______ / ________________________ (Home / Work)
  380.  
  381.  
  382.       Date: _________________________
  383.  
  384.       Description of problem or enhancement:
  385.  
  386.       ________________________________________________________________
  387.  
  388.       ________________________________________________________________
  389.  
  390.       ________________________________________________________________
  391.  
  392.       ________________________________________________________________
  393.  
  394.  
  395.       Suggested solution:
  396.  
  397.       ________________________________________________________________
  398.  
  399.       ________________________________________________________________
  400.                                                                 Page 11
  401.                                 P A T T R
  402.  
  403.       Program Maintenance:
  404.       --------------------
  405.  
  406.       Version 1.0     October 15, 1986
  407.  
  408.  
  409.